home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / gfx / conv / jpegV5Asrc.lha / jpeg-5a / filelist.doc < prev    next >
Text File  |  1994-09-23  |  7KB  |  186 lines
  1. IJG JPEG LIBRARY:  FILE LIST
  2.  
  3. Copyright (C) 1994, Thomas G. Lane.
  4. This file is part of the Independent JPEG Group's software.
  5. For conditions of distribution and use, see the accompanying README file.
  6.  
  7.  
  8. Here is a road map to the files in the IJG JPEG distribution.  The
  9. distribution includes the JPEG library proper, plus two application
  10. programs ("cjpeg" and "djpeg") which use the library to convert JPEG
  11. files to and from some other popular image formats.  There are also
  12. two stand-alone applications, "rdjpgcom" and "wrjpgcom".
  13.  
  14.  
  15. THE JPEG LIBRARY
  16. ================
  17.  
  18. Include files:
  19.  
  20. jpeglib.h    JPEG library's exported data and function declarations.
  21. jconfig.h    Configuration declarations.  Note: this file is not present
  22.         in the distribution; it is generated during installation.
  23. jmorecfg.h    Additional configuration declarations; need not be changed
  24.         for a standard installation.
  25. jerror.h    Declares JPEG library's error and trace message codes.
  26. jinclude.h    Central include file used by library's .c files.
  27. jpegint.h    JPEG library's internal data structures.
  28. jdct.h        Private declarations for forward & reverse DCT subsystems.
  29. jmemsys.h    Private declarations for memory management subsystem.
  30. jversion.h    Version information.
  31.  
  32. Applications using the library should include jpeglib.h (which in turn
  33. includes jconfig.h and jmorecfg.h).  Optionally, jerror.h may be included
  34. if the application needs to reference individual JPEG error codes.  The
  35. other include files are intended for internal use and would not normally
  36. be included by an application program.  (cjpeg/djpeg do use jinclude.h,
  37. since its function is to improve portability of the whole IJG distribution.
  38. Most other applications will directly include the system include files they
  39. want, and hence won't need jinclude.h.)
  40.  
  41.  
  42. C source code files:
  43.  
  44. These files contain most of the functions intended to be called directly by
  45. an application program:
  46.  
  47. jcapi.c        Application program interface routines for compression.
  48. jdapi.c        Application program interface routines for decompression.
  49. jcomapi.c    Application program interface routines common to compression
  50.         and decompression.
  51. jcparam.c    Compression parameter setting helper routines.
  52.  
  53. Compression side of the library:
  54.  
  55. jcmaster.c    Master control: determines which other modules to use.
  56. jcmainct.c    Main buffer controller (preprocessor => JPEG compressor).
  57. jcprepct.c    Preprocessor buffer controller.
  58. jccoefct.c    Buffer controller for DCT coefficient buffer.
  59. jccolor.c    Color space conversion.
  60. jcsample.c    Downsampling.
  61. jcdctmgr.c    DCT manager (DCT implementation selection & control).
  62. jfdctint.c    Forward DCT using slow-but-accurate integer method.
  63. jfdctfst.c    Forward DCT using faster, less accurate integer method.
  64. jfdctflt.c    Forward DCT using floating-point arithmetic.
  65. jchuff.c    Huffman entropy coding.
  66. jcmarker.c    JPEG marker writing.
  67. jdatadst.c    Data destination manager for stdio output.
  68.  
  69. Decompression side of the library:
  70.  
  71. jdmaster.c    Master control: determines which other modules to use.
  72. jdmainct.c    Main buffer controller (JPEG decompressor => postprocessor).
  73. jdcoefct.c    Buffer controller for DCT coefficient buffer.
  74. jdpostct.c    Postprocessor buffer controller.
  75. jdmarker.c    JPEG marker reading.
  76. jdhuff.c    Huffman entropy decoding.
  77. jddctmgr.c    IDCT manager (IDCT implementation selection & control).
  78. jidctint.c    Inverse DCT using slow-but-accurate integer method.
  79. jidctfst.c    Inverse DCT using faster, less accurate integer method.
  80. jidctflt.c    Inverse DCT using floating-point arithmetic.
  81. jidctred.c    Inverse DCTs with reduced-size outputs.
  82. jdsample.c    Upsampling.
  83. jdcolor.c    Color space conversion.
  84. jdmerge.c    Merged upsampling/color conversion (faster, lower quality).
  85. jquant1.c    One-pass color quantization using a fixed-spacing colormap.
  86. jquant2.c    Two-pass color quantization using a custom-generated colormap.
  87.         Also handles one-pass quantization to an externally given map.
  88. jdatasrc.c    Data source manager for stdio input.
  89.  
  90. Support files for both compression and decompression:
  91.  
  92. jerror.c    Standard error handling routines (application replaceable).
  93. jmemmgr.c    System-independent (more or less) memory management code.
  94. jutils.c    Miscellaneous utility routines.
  95.  
  96. jmemmgr.c relies on a system-dependent memory management module.  The IJG
  97. distribution includes the following implementations of the system-dependent
  98. module:
  99.  
  100. jmemnobs.c    "No backing store": assumes adequate virtual memory exists.
  101. jmemansi.c    Makes temporary files with ANSI-standard routine tmpfile().
  102. jmemname.c    Makes temporary files with program-generated file names.
  103. jmemdos.c    Custom implementation for MS-DOS: knows about extended and
  104.         expanded memory as well as temporary files.
  105.  
  106. Exactly one of the system-dependent modules should be configured into an
  107. installed JPEG library (see install.doc for hints about which one to use).
  108. On unusual systems you may find it worthwhile to make a special
  109. system-dependent memory manager.
  110.  
  111.  
  112. Non-C source code files:
  113.  
  114. jmemdosa.asm    80x86 assembly code support for jmemdos.c; used only in
  115.         MS-DOS-specific configurations of the JPEG library.
  116.  
  117.  
  118. CJPEG/DJPEG
  119. ===========
  120.  
  121. Include files:
  122.  
  123. cdjpeg.h    Declarations shared by cjpeg/djpeg modules.
  124. cderror.h    Additional error and trace message codes for cjpeg/djpeg.
  125.  
  126. C source code files:
  127.  
  128. cjpeg.c        Main program for cjpeg.
  129. djpeg.c        Main program for djpeg.
  130. rdcolmap.c    Code to read a colormap file for djpeg's "-map" option.
  131.  
  132. Image file reader modules for cjpeg:
  133.  
  134. rdbmp.c        BMP file input.
  135. rdgif.c        GIF file input.
  136. rdppm.c        PPM/PGM file input.
  137. rdrle.c        Utah RLE file input.
  138. rdtarga.c    Targa file input.
  139.  
  140. Image file writer modules for djpeg:
  141.  
  142. wrbmp.c        BMP file output.
  143. wrgif.c        GIF file output.
  144. wrppm.c        PPM/PGM file output.
  145. wrrle.c        Utah RLE file output.
  146. wrtarga.c    Targa file output.
  147.  
  148.  
  149. RDJPGCOM/WRJPGCOM
  150. =================
  151.  
  152. C source code files:
  153.  
  154. rdjpgcom.c    Stand-alone rdjpgcom application.
  155. wrjpgcom.c    Stand-alone wrjpgcom application.
  156.  
  157. These programs do not depend on the IJG library.  They do use
  158. jconfig.h and jinclude.h, simply to improve portability.
  159.  
  160.  
  161. ADDITIONAL FILES
  162. ================
  163.  
  164. Documentation (see README for a guide to the documentation files):
  165.  
  166. README        Master documentation file.
  167. *.doc        Other documentation files.
  168. *.1        Documentation in Unix man page format.
  169. change.log    Version-to-version change highlights.
  170. example.c    Sample code for calling JPEG library.
  171.  
  172. Configuration/installation files and programs (see install.doc for more info):
  173.  
  174. configure    Unix shell script to perform automatic configuration.
  175. ckconfig.c    Program to generate jconfig.h on non-Unix systems.
  176. jconfig.doc    Template for making jconfig.h by hand.
  177. makefile.*    Sample makefiles for particular systems.
  178. jconfig.*    Sample jconfig.h for particular systems.
  179. ansi2knr.c    De-ANSIfier for pre-ANSI C compilers (courtesy of
  180.         L. Peter Deutsch and Aladdin Enterprises).
  181.  
  182. Test files (see install.doc for test procedure):
  183.  
  184. test*.*        Source and comparison files for confidence test.
  185.         These are binary image files, NOT text files.
  186.